home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glcopyteximage2d.z / glcopyteximage2d
Encoding:
Text File  |  2002-10-03  |  19.0 KB  |  269 lines
  1.  
  2.  
  3.  
  4. ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))           OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee           ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD - copy pixels into a 2D texture image
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD( GLenum _t_a_r_g_e_t,
  14.                             GLint _l_e_v_e_l,
  15.                             GLenum _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  16.                             GLint _x,
  17.                             GLint _y,
  18.                             GLsizei _w_i_d_t_h,
  19.                             GLsizei _h_e_i_g_h_t,
  20.                             GLint _b_o_r_d_e_r )
  21.  
  22.  
  23. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  24.      _t_a_r_g_e_t          Specifies the target texture.  Must be GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD.
  25.  
  26.      _l_e_v_e_l           Specifies the level-of-detail number.  Level 0 is the
  27.                      base image level.  Level _n is the _nth mipmap reduction
  28.                      image.
  29.  
  30.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  Specifies the internal format of the texture.  Must be
  31.                      one of the following symbolic constants:  GGGGLLLL____AAAALLLLPPPPHHHHAAAA,
  32.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666,
  33.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888,
  34.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  35.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222,
  36.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444,
  37.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666,
  38.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY4444, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY8888,
  39.                      GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11112222, GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY11116666, GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____RRRR3333____GGGG3333____BBBB2222,
  40.                      GGGGLLLL____RRRRGGGGBBBB4444, GGGGLLLL____RRRRGGGGBBBB5555, GGGGLLLL____RRRRGGGGBBBB8888, GGGGLLLL____RRRRGGGGBBBB11110000, GGGGLLLL____RRRRGGGGBBBB11112222, GGGGLLLL____RRRRGGGGBBBB11116666,
  41.                      GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA4444, GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111, GGGGLLLL____RRRRGGGGBBBBAAAA8888,
  42.                      GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222, GGGGLLLL____RRRRGGGGBBBBAAAA11112222, or GGGGLLLL____RRRRGGGGBBBBAAAA11116666.
  43.  
  44.      _x, _y            Specify the window coordinates of the lower left corner
  45.                      of the rectangular region of pixels to be copied.
  46.  
  47.      _w_i_d_t_h           Specifies the width of the texture image.  Must be 0 or
  48.                       n
  49.                      2  + 2*_b_o_r_d_e_r for some integer n.
  50.  
  51.      _h_e_i_g_h_t          Specifies the height of the texture image.  Must be 0 or
  52.                       m
  53.                      2  + 2*_b_o_r_d_e_r for some integer m.
  54.  
  55.      _b_o_r_d_e_r          Specifies the width of the border.  Must be either 0 or
  56.                      1.
  57.  
  58. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  59.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD defines a two-dimensional texture image with pixels from
  60.      the current GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR.
  61.  
  62.  
  63.  
  64.  
  65.                                                                         PPPPaaaaggggeeee 1111
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))           OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee           ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))
  73.  
  74.  
  75.  
  76.      The screen-aligned pixel rectangle with lower left corner at (_x, _y) and
  77.      with a width of _w_i_d_t_h + 2 * _b_o_r_d_e_r and a height of _h_e_i_g_h_t + 2 * _b_o_r_d_e_r
  78.      defines the texture array at the mipmap level specified by _l_e_v_e_l.
  79.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t specifies the internal format of the texture array.
  80.  
  81.      The pixels in the rectangle are processed exactly as if ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss had
  82.      been called, but the process stops just before final conversion.  At this
  83.      point all pixel component values are clamped to the range [0,1] and then
  84.      converted to the texture's internal format for storage in the texel
  85.      array.
  86.  
  87.      Pixel ordering is such that lower x and y screen coordinates correspond
  88.      to lower s and t texture coordinates.
  89.  
  90.      If any of the pixels within the specified rectangle of the current
  91.      GGGGLLLL____RRRREEEEAAAADDDD____BBBBUUUUFFFFFFFFEEEERRRR are outside the window associated with the current
  92.      rendering context, then the values obtained for those pixels are
  93.      undefined.
  94.  
  95. NNNNOOOOTTTTEEEESSSS
  96.      ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD is available only if the GL version is 1.1 or greater.
  97.  
  98.      Texturing has no effect in color index mode.
  99.  
  100.      1, 2, 3, and 4 are not accepted values for _i_n_t_e_r_n_a_l_f_o_r_m_a_t.
  101.  
  102.      An image with height or width of 0 indicates a NULL texture.
  103.  
  104.      When the GGGGLLLL____AAAARRRRBBBB____iiiimmmmaaaaggggiiiinnnngggg extension is supported, the RGBA components read
  105.      from the framebuffer may be processed by the imaging pipeline.  See
  106.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD for specific details.
  107.  
  108. EEEERRRRRRRROOOORRRRSSSS
  109.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD.
  110.  
  111.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _l_e_v_e_l is less than 0.
  112.  
  113.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE may be generated if _l_e_v_e_l is greater than log max, where
  114.                                                                    2
  115.      max is the returned value of GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE.
  116.  
  117.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _w_i_d_t_h or _h_e_i_g_h_t is less than 0, greater
  118.      than 2 + GGGGLLLL____MMMMAAAAXXXX____TTTTEEEEXXXXTTTTUUUURRRREEEE____SSSSIIIIZZZZEEEE, or if _w_i_d_t_h or _h_e_i_g_h_t cannot be represented
  119.          k
  120.      as 2  + 2 * _b_o_r_d_e_r for some integer k.
  121.  
  122.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _b_o_r_d_e_r is not 0 or 1.
  123.  
  124.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not one of the
  125.      allowable values.
  126.  
  127.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD is executed between
  128.      the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  129.  
  130.  
  131.  
  132.  
  133.                                                                         PPPPaaaaggggeeee 2222
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140. ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))           OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee           ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))
  141.  
  142.  
  143.  
  144. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  145.      ggggllllGGGGeeeettttTTTTeeeexxxxIIIImmmmaaaaggggeeee
  146.      ggggllllIIIIssssEEEEnnnnaaaabbbblllleeeedddd with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD
  147.  
  148.  
  149. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  150.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems do not support color
  151.      matrix transformations on images as they are loaded to or read back from
  152.      texture memory.
  153.  
  154.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems support ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD
  155.      and ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT with the following restrictions:
  156.  
  157.           1.  Only level 0 is supported; other levels result in a
  158.               GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE error.
  159.  
  160.           2.  ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD and ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDDEEEEXXXXTTTT cannot be used if a GLX
  161.               video source is the current read drawable (see
  162.               ggggllllXXXXMMMMaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnnttttRRRReeeeaaaaddddSSSSGGGGIIII).  Executing it will generate a
  163.               GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN error.
  164.  
  165.           3.  GGGGLLLL____IIIINNNNTTTTEEEERRRRLLLLAAAACCCCEEEE____SSSSGGGGIIIIXXXX is not supported (see ggggllllEEEEnnnnaaaabbbblllleeee).
  166.  
  167.           4.  Borders are not supported; hence the width of the border should
  168.               be 0.
  169.  
  170.      On IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems, there is a performance benefit when the width
  171.      of the image to be transferred to texture memory is a multiple of 8.
  172.  
  173.      Texture borders are not supported on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy systems.
  174.      Applications should use borderless textures and GGGGLLLL____CCCCLLLLAAAAMMMMPPPP____TTTTOOOO____EEEEDDDDGGGGEEEE____SSSSGGGGIIIISSSS
  175.      wrap mode.
  176.  
  177.      The SSSSGGGGIIIIXXXX____iiiinnnntttteeeerrrrllllaaaacccceeee extension is supported only on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy
  178.      systems, on RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems, on OOOOccccttttaaaannnneeee2222
  179.      VVVVPPPPrrrroooo systems, and on OOOO2222 systems.
  180.  
  181.      The IIIINNNNGGGGRRRR____iiiinnnntttteeeerrrrllllaaaacccceeee____rrrreeeeaaaadddd extension is supported only on OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo
  182.      systems, and on OOOO2222 systems.
  183.  
  184.      On HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt systems the number of bits per
  185.      component, represented internally, is the same for all components and
  186.      will be 4, 8, or 12 bits per component. All specified internal formats
  187.      will receive an equal or greater representation in this scheme, up to the
  188.      12-bit limit.  HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Indigo2 systems do not
  189.      support texture internal formats of the type GGGGLLLL____IIIINNNNTTTTEEEENNNNSSSSIIIITTTTYYYY or GGGGLLLL____AAAALLLLPPPPHHHHAAAA,
  190.      although HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Octane systems do support
  191.      these types.
  192.  
  193.      HHHHiiiigggghhhh IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt on Indigo2 systems without the TRAM option
  194.      card support 4 bits per component for GGGGLLLL____RRRRGGGGBBBB and GGGGLLLL____RRRRGGGGBBBBAAAA, 4/8 bits per
  195.      component for GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA, and 4/8/12 bits per component for
  196.  
  197.  
  198.  
  199.                                                                         PPPPaaaaggggeeee 3333
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206. ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))           OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee           ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD((((3333GGGG))))
  207.  
  208.  
  209.  
  210.      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE.
  211.  
  212.  
  213. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  214.      ggggllllCCCCooooppppyyyyPPPPiiiixxxxeeeellllssss, ggggllllCCCCooooppppyyyyTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllCCCCooooppppyyyyTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD,
  215.      ggggllllPPPPiiiixxxxeeeellllSSSSttttoooorrrreeee, ggggllllPPPPiiiixxxxeeeellllTTTTrrrraaaannnnssssffffeeeerrrr, ggggllllTTTTeeeexxxxEEEEnnnnvvvv, ggggllllTTTTeeeexxxxGGGGeeeennnn, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
  216.      ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee1111DDDD, ggggllllTTTTeeeexxxxSSSSuuuubbbbIIIImmmmaaaaggggeeee2222DDDD, ggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                                                                         PPPPaaaaggggeeee 4444
  266.  
  267.  
  268.  
  269.